- Coverage
- 100%
470 out of 470 items documented4 out of 359 items with examples - Links
- Homepage
- Documentation
-
getsentry/symbolic
445 75 9 - crates.io
- Dependencies
-
- debugid ^0.8.0 normal
- elementtree ^1.2.3 normal optional
- elsa ^1.8.0 normal optional
- fallible-iterator ^0.3.0 normal
- flate2 ^1.0.25 normal optional
- gimli ^0.31.0 normal optional
- goblin ^0.8.0 normal optional
- lazy_static ^1.4.0 normal optional
- nom ^7.1.3 normal optional
- nom-supreme ^0.8.0 normal optional
- once_cell ^1.17.1 normal optional
- parking_lot ^0.12.1 normal optional
- pdb-addr2line ^0.10.4 normal optional
- regex ^1.7.1 normal optional
- scroll ^0.12.0 normal optional
- serde ^1.0.171 normal
- serde_json ^1.0.102 normal optional
- smallvec ^1.10.0 normal optional
- symbolic-common ^12.11.1 normal
- symbolic-ppdb ^12.11.1 normal optional
- thiserror ^1.0.39 normal
- wasmparser ^0.214.0 normal optional
- zip ^2.1.4 normal optional
- zstd ^0.13.1 normal optional
- criterion ^0.5.1 dev
- insta ^1.28.0 dev
- similar-asserts ^1.4.2 dev
- tempfile ^3.4.0 dev
- Versions
-
- 12.11.1
- 12.11.0
- 12.10.1
- 12.10.0
- 12.9.2
- 12.9.1
- 12.8.0
- 12.7.1
- 12.7.0
- 12.6.0
- 12.5.0
- 12.4.1
- 12.4.0
- 12.3.0
- 12.2.0
- 12.1.6
- 12.1.5
- 12.1.4
- 12.1.3
- 12.1.2
- 12.1.1
- 12.1.0
- 12.0.0
- 11.1.0
- 11.0.0
- 10.2.1
- 10.2.0
- 10.1.5
- 10.1.4
- 10.1.3
- 10.1.2
- 10.1.1
- 10.1.0
- 10.0.0
- 9.2.1
- 9.2.0
- 9.1.4
- 9.1.3
- 9.1.2
- 9.1.1
- 9.1.0
- 9.0.0
- 8.8.0
- 8.7.3
- 8.7.2
- 8.7.1
- 8.7.0
- 8.6.1
- 8.6.0
- 8.5.0
- 8.4.0
- 8.3.2
- 8.3.1
- 8.3.0
- 8.2.1
- 8.2.0
- 8.1.0
- 8.0.5
- 8.0.4
- 8.0.3
- 8.0.2
- 8.0.1
- 8.0.0
- 7.5.0
- 7.4.0
- 7.3.6
- 7.3.5
- 7.3.4
- 7.3.3
- 7.3.2
- 7.3.1
- 7.3.0
- 7.2.0
- 7.1.1
- 6.1.4
- 6.1.3
- 6.1.0
- 6.0.6
- 6.0.5
- 6.0.4
- 6.0.3
- 6.0.0
- 5.7.8
- 5.7.7
- 5.7.6
- 5.7.5
- 5.7.4
- 5.7.3
- 5.7.2
- 5.7.1
- 5.7.0
- 5.5.6
- 5.5.5
- 5.5.4
- 5.5.3
- 5.5.2
- 5.5.1
- 5.5.0
- 5.4.0
- 5.3.0
- 5.2.0
- 5.1.2
- 5.1.1
- 5.1.0
- 5.0.2
- 5.0.1
- 5.0.0
- 4.0.0
- 3.0.1
- 2.0.7
- 2.0.6
- 2.0.5
- 2.0.4
- 2.0.3
- 2.0.2
- 2.0.1
- 2.0.0
- 1.1.5
- Owners
-
Abstractions for dealing with object files and debug information.
This module defines the [`Object`] type, which is an abstraction over various object file
formats used in different platforms. Also, since executables on MacOS might contain multiple
object files (called a _"Fat MachO"_), there is an [`Archive`] type, that provides a uniform
interface with access to an objects iterator in all platforms.
Most processing of object files will happen on the `Object` type or its concrete implementation
for one platform. To allow abstraction over this, there is the [`ObjectLike`] trait. It defines
common attributes and gives access to a [`DebugSession`], which can be used to perform more
stateful handling of debug information.
See [`Object`] for the full API, or use one of the modules for direct access to the
platform-dependent data.
# Background
The functionality of `symbolic::debuginfo` is conceptionally similar to the [`object crate`].
However, there are key differences that warranted a separate implementation:
- `object` has a stronger focus on executable formats, while `symbolic` focusses on debugging
information. This is why `symbolic` also includes a variant for PDBs and Breakpad objects,
where `object` instead has a WASM variant.
- `object` contains far more generic access to the data within objects at the cost of
performance. `symbolic` tries to optimize for debugging scenarios at the cost of generic
usage.
- `symbolic` contains an abstraction for multi-object files ([`Archive`]), which is not easily
possible in `object` due to the use of lifetimes on the `object::Object` trait.
[`Object`]: enum.Object.html
[`Archive`]: enum.Archive.html
[`ObjectLike`]: trait.ObjectLike.html
[`DebugSession`]: trait.DebugSession.html
[`object crate`]: https://docs.rs/object